package com.smart.community.property.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.smart.community.property.entity.FeeRule;

import java.time.LocalDate;
import java.util.List;

/**
 * 费用规则服务接口
 * @author Wu.Liang
 * @since 2024-12-21
 */
public interface IFeeRuleService extends IService<FeeRule> {
    
    /**
     * 分页查询费用规则
     * @param page 分页参数
     * @param feeType 费用类型
     * @param communityId 社区ID
     * @param status 状态
     * @return 分页结果
     * @throws Exception 统一异常
     */
    IPage<FeeRule> getFeeRulePage(Page<FeeRule> page, Integer feeType, Long communityId, Integer status) throws Exception;
    
    /**
     * 根据费用类型和社区ID查询活跃规则
     * @param feeType 费用类型
     * @param communityId 社区ID
     * @param date 日期
     * @return 费用规则列表
     * @throws Exception 统一异常
     */
    List<FeeRule> getActiveRulesByTypeAndCommunity(Integer feeType, Long communityId, LocalDate date) throws Exception;
    
    /**
     * 获取最新的费用规则
     * @param feeType 费用类型
     * @param communityId 社区ID
     * @return 费用规则
     * @throws Exception 统一异常
     */
    FeeRule getLatestRule(Integer feeType, Long communityId) throws Exception;
} 